home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 744 / nfd / nfd.readme < prev    next >
Text File  |  1995-03-18  |  5KB  |  120 lines
  1.     +------------------------------------------------------+
  2.     |NFD (Newest File Data) © (copyright) 1991 Jon Maxwell |
  3.     +------------------------------------------------------+
  4.     |This program may be freely distributed, but I reserve |
  5.     |all rights to it and to the source code.              |
  6.     +------------------------------------------------------+
  7.     |USAGE: NFD [±Pattern] [Directory] [Command]           |
  8.     |  [Command] is the line to be run with the newest file|
  9.     |name, in this form: (Text)¿(Text) where (Text) is part|
  10.     |of the command and ¿ (shift-alt-M) determines where   |
  11.     |the file name will be inserted.                       |
  12.     |  a + pattern means that it must match that pattern, a|
  13.     |- means that it must not match. Do not use any pattern|
  14.     |symbols (*,#?,?,etc)                                  |
  15.     +------------------------------------------------------+
  16.     |  If there is no [Command] parameter, NFD will assume |
  17.     |that you have ARP and will set an ARP global variable |
  18.     |under the name of $FileName.                          |
  19.     +------------------------------------------------------+
  20.     |Source compiled with Patrick Quaid's PCQ              |
  21.     +------------------------------------------------------+
  22.  
  23. AUTHOR
  24. ------
  25. This program, NFD, is a work of Jon Maxwell. I grant you the right to
  26. copy it and to use it as you see fit. The only restriction to distribution
  27. is that all files in the original archive must be intact and unchanged.
  28. The source code, in Pascal, is just for you to look at. You can of course
  29. recompile it, but any recompiled code and/or modified code cannot be
  30. distributed without my written permission.
  31.  
  32.  
  33. GUARANTEE
  34. ---------
  35. This program, NFD, is not guaranteed in any way. Should any problem
  36. develope, I will not be responsible. Use at your own risk. I have found
  37. no problems in it, and it _should_ work with any system configuration,
  38. but I have not had any chance to test this. It also _should_ not do
  39. anything it wasn't intended to do, but I make no promises.
  40.  
  41.  
  42. WHAT IT DOES
  43. ------------
  44. This program, NFD, will search through a directory specified in the
  45. parameters (no parameters will mean the current directory) for the
  46. newest file. Subdirectories are not considered for the newest file, thus
  47. ensuring that it will be a file. When it is done searching the directory,
  48. it returns the newest file's name in a global variable called "FileName".
  49. If there happens to be no file in a directory then it returns the global
  50. variable as a "!" (don't ask why!).
  51.  
  52.  
  53. Unfortunately, the global variables only work under ARP. This would make
  54. this program do nothing useful without ARP (it would search a dir, but
  55. when it returned information it will make an error). To get around this
  56. problem, I added a second CLI parameter. When this parameter is present,
  57. NFD assumes that you do Not Have ARP. The second parameter is a CLI line
  58. that will be executed by NFD. If it contains spaces, put quotation marks
  59. (") around the line. Where you want the newest file name to be inserted,
  60. simply put a ¿ (shift+alt+M). You may only put one insertion of the newest
  61. file name into the line. Speaking of quotation marks, NFD will automatically
  62. put them around the inserted file name, IF the file name has spaces in it.
  63.  
  64.  
  65. USING PATTERNS
  66. --------------
  67. Pattern matching is one addition I have made since earlier versions. I
  68. hate it when you can only specify a PRO pattern; that is, a pattern
  69. for the files you want to include instead of exclude. This program will
  70. let you do both include and exclude type pattern matching. The actual
  71. matching is somewhat crude -- you can only set one item to look for.
  72. I don't really know how to say it, but maybe an example will do it for
  73. me. Okay, you can look for any file that contains a ".info" or some other
  74. whole group of characters. You can't look for something that has a
  75. search pattern of, say, "Am#?.info." The format is very simple: Between
  76. the first parameter and the program name, insert a + or - followed by
  77. the pattern. If the pattern contains spaces, put quotes around the
  78. whole thing (+ and - included). Be sure not to put any pattern symbols
  79. in it (*, #?, ?, etc.). A + pattern means everything must match the
  80. pattern, and a - means that everything must NOT match the pattern.
  81.  
  82.  
  83. POSSIBLE USES
  84. -------------
  85. The possible uses for this program are many, mostly related to making
  86. assorted things automatic. For instance, you could make a script that
  87. would run your favorite text editor or word processor with the last
  88. text that you were working on as a parameter for it (thus letting you
  89. easily resume where you left off).
  90.  
  91.  
  92. KNOWN BUGS
  93. ----------
  94. There is one known bug as of this time. For some strange reason, NFD
  95. defaults to ARP mode if the second parameter is a one character one. A
  96. way to get around this is to always put the second parameter enclosed
  97. in quotation marks (").
  98.  
  99.  
  100. THE FUTURE
  101. ----------
  102. There are plans for future enhancement if enough people take interest
  103. in this program. The only thing I could add to it, that I can think of
  104. now, is a subdirectory search. As it is now, it will ONLY search in the
  105. directory specified.
  106.  
  107.  
  108. =========
  109. READ THIS
  110. =========
  111. I hope you enjoy this program, and it is useful. If you _want_ to send
  112. me money, or you have suggestions, send it to this address:
  113.  
  114. Jon Maxwell
  115. 7706 Hillview Avenue
  116. Richmond, Virginia 23229
  117.  
  118. Or, send E-Mail to Scruffy at any local Richmond, VA, area Amiga BBS (such
  119. as Late Night Amiga: 804-262-9944).
  120.